home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / pc_board / ttp15.zip / TIC2PCB.DOC < prev    next >
Text File  |  1992-09-11  |  10KB  |  293 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.      ▀▀▀▀█▀▀▀▀                  ▄▀▀▄            ▀█▀▀▀▀█ █▀▀▀▀█ ▀█▀▀▀▀█
  8.          █                     ▀    █            █    █ █       █    █
  9.          █   ▀ █▀▀▀▀              ▄▀             █▄▄▄▄█ █       █▄▄▄▄▀
  10.          █   █ █        ▀▀▀     ▄▀       ▀▀▀     █      █       █    █
  11.          █   █ █▄▄▄▄           █▄▄▄▄▄           ▄█▄     █▄▄▄▄█ ▄█▄▄▄▄█
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.                                Version 1.5
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.                                 Copyright (C) 1992
  39.                                         by
  40.                                     Tom Carroll
  41.  
  42.  
  43.                                 All rights reserved
  44.  
  45.  
  46.  
  47.                                  The Data Shop BBS
  48.                                 (509)582-9493 (HST)
  49.                                    Kennewick, WA
  50.                               FIDO address (1:347/10)
  51.  
  52.                               MAGIC FILE NAME: TIC2PCB
  53.     ┌──────────────┐
  54.     │ INTRODUCTION │
  55.     └──────────────┘
  56.  
  57.     Tic-2-PCB was written because I wanted a program that would be very easy to
  58.     configure, and that would move the new files I get from time to time off the
  59.     FIDO SDN networks to my uploads directory.  I looked at the program called
  60.     TICK, but again, it was a program that required an extensive configuration
  61.     file, and it was very hard to understand the formatting of the directory
  62.     entries, Hence, Tic-2-PCB was born.
  63.  
  64.     ┌──────────────┐
  65.     │  DISCLAIMER  │
  66.     └──────────────┘
  67.  
  68.     This software is provided without any guarantee or warranty either expressed
  69.     or implied.  I will not be held responsible for ANY damages that may result
  70.     in the use of this program.  "ANY" means if you install it, run it, and it
  71.     eats your programs that you've been working on for 2 years without a backup,
  72.     IT'S NOT MY FAULT!!!
  73.  
  74.     Tic-2-PCB software and this document are Copyright (C) 1992 by Tom Carroll. 
  75.     All rights reserved.
  76.  
  77.     ┌──────────────┐
  78.     │   LICENSE    │
  79.     └──────────────┘
  80.  
  81.     This program is being released as FREEWARE.  The source code will remain
  82.     the property of the author unless otherwise released by him.
  83.  
  84.     You are free to use this version of the program without any cost of
  85.     registration.  This however, may change at any time with a new version
  86.     release. (If this should happen, a one time registration fee will be asked)
  87.  
  88.     No one may alter, modify, or reverse engineer Tic-2-PCB for any reason,
  89.     including but not limited to decompiling-compiling, patching, or
  90.     disassembling.
  91.  
  92.     You may freely distribute & copy this program for others subject to the
  93.     above restrictions and the following:
  94.  
  95.          ■ Tic-2-PCB is copied in unmodified form including this file. 
  96.          ■ There is no charge for copying except for the cost of disks.
  97.          ■ Tic-2-PCB is not included in another software package
  98.            without the express written permission of Tom Carroll
  99.  
  100.     ┌──────────────┐
  101.     │   SUPPORT    │
  102.     └──────────────┘
  103.  
  104.     If you should find any problems with this program, or you have any requests
  105.     or recommendations, you may reach me on my BBS, or at the FIDO address
  106.     listed on the front cover.  I may also be reached in the QUIK_BAS & PCBNET
  107.     FIDO echo's.
  108.  
  109.     Tic-2-PCB Supports .TIC files from TICK and FEcho file processors.
  110.  
  111.  
  112.     Tic-2-PCB v1.5                                                       Page 2
  113.     ┌──────────────┐
  114.     │  THE AUTHOR  │
  115.     └──────────────┘
  116.  
  117.     This is my first public program.  I'm planning on more, but for now, this
  118.     will have to be my way of testing the waters...
  119.  
  120.     I have been writing in BASIC for about 7 years, and I really like it, but 
  121.     I'm planning on taking a course in "C" this fall, so this might be my last 
  122.     summer programming in BASIC.
  123.  
  124.     I am presently active duty in the U.S. Coast Guard, and have been a "Sysop"
  125.     for their computer systems at my duty stations for about 6 years.
  126.  
  127.     I would like to thank my wife, who always says "Are you coming to bed, or
  128.     are you going to keep PLAYING on that computer?"
  129.  
  130.     ┌──────────────┐
  131.     │    FILES     │
  132.     └──────────────┘
  133.  
  134.     Files included in this archive:
  135.  
  136.               TIC2PCB.DOC - This manual (enormously big manual)
  137.               TIC2PCB.CFG - This really huge configuration file... NOT!
  138.               TIC2PCB.HIS - Tic-2-PCB's metamorphosis
  139.               TIC2PCB.LOG - Sample log file
  140.               TIC2PCB.EXE - The meat of the game...
  141.               FILE_ID.DIZ - Description file for Tic-2-PCB
  142.  
  143.     I originally compressed this program as TTPnn.ARJ, but it may be
  144.     compressed with any other archive program you wish to use.
  145.  
  146.     The latest version will always be available on my BBS using the magic
  147.     filename of TIC2PCB.
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.     Now, on with the installation...
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.     Tic-2-PCB v1.5                                                       Page 3
  173.     ┌──────────────┐
  174.     │    SETUP     │
  175.     └──────────────┘
  176.  
  177.     All you need to do is complete the small configuration file.
  178.  
  179.     NOTE: Leave the directory offsets set to the default values if you
  180.           are running PCBoard v14.5a
  181.  
  182.     Here is an example of my configuration file:
  183.  
  184.     LINE      ENTRY                              DESCRIPTION
  185.     ────  ──────────────────        ───────────────────────────────────────────
  186.       1   C:\FD\FILES\              The location of your inbound files
  187.       2   C:\UPLOAD\                The name of your default import Directory
  188.       3   C:\PCB\MAIN\UPLOAD        The name of your default DIR import listing
  189.       4   C:\PCB\MAIN\DOWNLOAD.TXT  The name of your default DIR import listing
  190.       5   0                         Offset in dir file for file name
  191.       6   21                        Offset in dir file for file size
  192.       7   2                         Offset in dir file for file date
  193.       8   2                         Offset in dir file for file description
  194.       9   31                        Offset in dir file for sec. description
  195.      10   M                         M)ove or C)opy files to destination DIR
  196.      11   C                         K)eep or C)leanup .TIC's once imported
  197.      12   C                         Use File date or Current date for listing
  198.      13   2                         Number of areas you receive files from
  199.      14   Y                         Y)es or N)o to Create/Update TIC2PCB.LOG
  200.      15   Y                         Y)es or N)o to add info line to description
  201.           SOFTDIST                  Area Name
  202.           C:\MISC\                  Directory to place area files
  203.           C:\PCB\MAIN\MISC          Location of DIR listing
  204.           SDN_GAMES                 Area Name
  205.           C:\GAMES\                 Directory to place area files
  206.           C:\PCB\MAIN\GAMES         Location of DIR listing
  207.           NODEDIFF                  Area Name
  208.           C:\FREE\                  Directory to place area files
  209.           C:\PCB\MAIN\FREE          Location of DIR listing
  210.  
  211.     ┌──────────────┐
  212.     │    NOTES     │
  213.     └──────────────┘
  214.  
  215.     Lines after line 15 in the configuration file MUST follow a specific
  216.     pattern to work properly.  They are:
  217.  
  218.     AREA NAME
  219.     TOSS FILES TO
  220.     TOSS DESCRIPTIONS TO
  221.  
  222.     That's it!  Pretty short huh?  I think its great!
  223.  
  224.     Now, all you need to do is make sure you have the TIC2PCB.CFG file in the
  225.     same directory as the TIC2PCB.EXE file.
  226.  
  227.     Tic-2-PCB will update your DOWNLOAD.TXT file (or whatever you call it), and
  228.     will make the following entry:
  229.  
  230.     (U),TIC-2-PCB AREANAME,MM-DD-YYYY,HH:MM,FILENAME.EXT,L,0,9600
  231.     
  232.     Tic-2-PCB v1.5                                                       Page 4
  233.     This entry just tells your File Profilers that an upload by Tic-2-PCB of
  234.     a file from AREANAME on that date & time consisted of FILENAME.EXT, using
  235.     the L protocol (I used the L protocol to signify a local upload) with no
  236.     errors, with an average speed of 9600 CPS.
  237.  
  238.     There will be one log file created if it doesn't exist (should you select
  239.     that option) called TIC2PCB.LOG.  It will be in the following format:
  240.     
  241.     MM-DD-YY --- AREANAME --- FILENAME.EXT --- FILESIZE --- DESTINATION DOS DIR
  242.  
  243.     I recommend deleting this file, or not using it at all if you move or
  244.     receive a lot of files through FIDO.  In any case, should you use it, be
  245.     sure to check the size of it every now and then.
  246.  
  247.     When a file is received that isn't in any of your AREA declarations, it
  248.     will be imported into the default directory, and dir files listed in lines
  249.     2 & 3.  The TIC2PCB.LOG entry will be (if logging is on) UNKNOWN for AREA
  250.     name.  However, the "Received by Tic-2-PCB xx-xx-xx from AREANAME" in the
  251.     default DIR listing will show the area it was actually received from.
  252.  
  253.  
  254.     Here is an excerpt of my RUN.BAT file which shows how I process my tick
  255.     files:
  256.  
  257.     CD \FD
  258.     REM           ---------  CHECK FOR NEW FILES    ---------
  259.     IF EXIST C:\FD\FILES\*.TIC GOTO TICK
  260.  
  261.     This is my sub-routine to complete the new files import...
  262.  
  263.     :TICK
  264.     REM   ---------   APPLY THE LATEST TIC FILE AND FILES   ---------
  265.     CLS
  266.     ECHO  *********          PROCESSING .TIC FILE           *********
  267.     TIC2PCB
  268.     GOTO RESUME
  269.  
  270.     NOTE: This only works if you have Tic-2-PCB Cleanup (delete) the .TIC
  271.           files after importing the files.
  272.  
  273.     That's it, you shouldn't have to do anything else, but fire it up and see
  274.     how easy and quick it actually is.  I imported 8 files in about 10 seconds.
  275.  
  276.     ┌──────────────┐
  277.     │  DONATIONS   │
  278.     └──────────────┘
  279.  
  280.     This software is free for the taking.  I don't expect any monetary
  281.     payment for it, but if you feel compelled to make a donation, you may send
  282.     whatever contribution that you feel is reasonable to the following address:
  283.  
  284.                                 Tom Carroll
  285.                                 1922 W. 4th Avenue
  286.                                 Kennewick, WA  99336
  287.  
  288.  
  289.     Thanks, and enjoy...
  290.  
  291.  
  292.     Tic-2-PCB v1.5                                                       Page 5
  293.